home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 4 / Assassins 4 (1999)(Weird Science).iso / docs / puzzles / vanilla.doc < prev    next >
Text File  |  1992-09-02  |  19KB  |  587 lines
  1.  
  2.  
  3.   Vanilla Tetris v1.02 (C)1997 by Iain King
  4.  
  5.  
  6.       This is Shareware
  7.  
  8.  
  9.   Why another version of Tetris?  Who knows.  I just wanted to see if I could
  10. make one, and also because I couldn't find a standard Tetris game.  I've got
  11. Tetris Pro, but it has silly power ups (though the music is cool).  So this
  12. is my attempt.
  13.  
  14.    This Tetris is programmed in Blitz Basic 2, which was made by those cool
  15. dudes at Acid software.  Wahey!
  16.  
  17.    This program was tested on an A1200, because surprisingly enough, thats
  18. what I've got.  It should run on any Amiga at full speed.  It might not on a
  19. 500/500+/600, but I can't test it so tough.  It should run fine, just maybe
  20. slower.  
  21.  
  22.    N.B. I haven't implemented any music, mainly because music in games is
  23. usually really annoying, and if you want to listen to music, you stick your
  24. Hi-Fi on.  If you want you can switch the sound fx off as well.  I've
  25. integrated Tetris' sound control with your Television/Speakers.  Simply turn
  26. the volume control on your respective device to 0 and the sound will stop
  27. itself until you turn the volume back up.
  28.  
  29.  
  30.    Feel free to send me your palette's/block designs - if they're any good
  31. (lets face it - they'll be better then mine) I'll put them in the next
  32. release.
  33.  
  34.  
  35. ============================================================================
  36.  
  37.    Contents
  38.  
  39.        First, a note on controls. 
  40.        How to play the thing 
  41.        The game of Tetris 
  42.        The game of BiTetris 
  43.        The BlockDesign program 
  44.        The Grabber program 
  45.        The palette (changing it) 
  46.  
  47.       Lastly some other stuff
  48.  
  49.           This is Shareware 
  50.           Files 
  51.           Credits 
  52.           Bugs 
  53.           My addresses 
  54.           Version list 
  55.  
  56.  
  57.    Controls.
  58.    --------
  59.  
  60.       A joystick in port 1 (the joystick port) or the cursor keys may be
  61.       used to control Tetris.
  62.  
  63.       In the menus <Fire> and <Return> activates.
  64.  
  65.       In game, <Fire>, <Up-Arrow> and <Right Shift> rotate the shape around
  66.       Left/Right move shape left/right
  67.       Down drops shape 
  68.  
  69.  
  70.  
  71.    How to play?
  72.    ------------
  73.        After double clicking on tetris, a screen should open up at a menu,
  74. showing you four options:
  75.  
  76.  
  77.       Start
  78.       -----
  79.  
  80.          Simple - starts the game
  81.  
  82.  
  83.       Normal
  84.       ------
  85.  
  86.          This is showing that the difficulty is set at 'normal'.
  87.          Hitting it will cycle it through 'normal' 'hard' and 'very hard'
  88.          difficulty settings.
  89.  
  90.          The difficulties work like this:
  91.  
  92.             'normal'       Go up a level every 20 lines
  93.             'hard'         Go up a level every 10 lines
  94.             'very hard'    Go up a level every 05 lines
  95.             'impossible'   Go up a level every 01 line
  96.  
  97.          Level ranges from 1 to 50, where fifty is ludicrously fast (block
  98.          goes down a row every 1/50th of a second)
  99.  
  100.          There is a seperate score table for each level.
  101.  
  102.       Colour
  103.       ------
  104.  
  105.       Hitting this toggles it between 'colour' and 'black'.
  106.       Switches the backdrop colour.  'colour' generally looks nicer, but
  107. 'black' offers higher contrast (and maybe a smaller headache from watching
  108. the screen to long).
  109.  
  110.  
  111.       Quit
  112.       ----
  113.  
  114.       Saves high score table to current directory then quits
  115.  
  116.  
  117.     N.B.  BiTetris  has a couple other menus
  118.  
  119.  
  120.  
  121.    The game of Tetris
  122.    ------------------
  123.  
  124.    Once you hit start you're into Tetris properly. I'll briefly sum up what
  125. it's about for both of you who don't know.
  126.  
  127.    A randomly determined block appears at the top of the screen ( you can
  128. see what the next block is in the view window to the top-left).  It will
  129. start moving downward, and you will be able to guide it left and right and
  130. rotate it. When the block reaches the bottom, or lands on top of another
  131. block, it will sit there and another block will appear at the top of the
  132. screen for you to control.  This goes on until the screen is filled at which
  133. point its game over.  BUT WAIT!  The whole point is, that if you manage to
  134. lay the blocks so that an entire row is filled (i.e. a horizontal row with
  135. no gaps), it will disappear, and all the blocks above it will fall down into
  136. the space.  So all you have to do is keep making lines to stay alive for as
  137. long as possible.  Sounds simple don't it? :)
  138.  
  139.    A couple of hints:
  140.  
  141.        1) If your block won't rotate, it's probably because there is
  142.           something next to it stopping it : move it away from any obstacles
  143.  
  144.        2) A block doesn't land the second it touches something below it - you
  145.           can still slide it for a couple of moments.
  146.  
  147.        3) because of 2, if you've left an overhang, you can slide a block
  148.           under it to fill the gap.
  149.  
  150.        4) The more lines you get at once, the more points you get for doing
  151.           it, and there is a special bonus for completely clearing the
  152.           screen.
  153.  
  154.  
  155.  
  156.    The game of BiTetris
  157.    --------------------
  158.  
  159.    BiTetris is the two-player equivelant of Tetris.  Both players play at
  160. once on two seperate boards (one uses keys, other joystick), and no scores
  161.  are recorded.  Instead, the winner is simply the person who does not die,
  162. i.e. the one who lasts longest.  As soon as one person dies, the game stops.
  163.  Of course, this isn't just abouut survival, oh no!  If you get more than
  164. a single line (i.e. a double, triple or a tetris) then your opponent recieves
  165. that many lines minus one.  i.e. if you get
  166.  
  167.  
  168.    a double             he gets 1 line
  169.    a triple             he gets 2 lines
  170.    a tetris             he gets 3 lines
  171.  
  172.    He recieves these lines next time he puts down his block, and they appear
  173. at the bottom of his board, forcing the blocks on the board upwards.  If any
  174. block goes off the top of the board then the player dies.
  175.  
  176.    N.B.   If you were to get, say, two Tetris' before he put his block down,
  177. then they *would* add up.  i.e. next time he put the block down he would get
  178. six lines.  If you were lucky enough and quick enough you could kill him
  179. *very* quickly (if you got something like 3 or 4 Tetris' in a row)
  180.  
  181.  
  182.  
  183.    Menus
  184.    -----
  185.  
  186.    There are a few extra menus :
  187.  
  188.  
  189.       get n
  190.       -----
  191.  
  192.       This is basically how full the lines are that your opponent gets when
  193. yu get doubles/triples/tetris'.  The number of blocks filled in in the line
  194. will average out to this number.  ex:
  195.  
  196.       if set to 5 and you scored a tetris' then it might come out like this:
  197.  
  198.  
  199.             |          |
  200.             |#  # ## # |
  201.             | ### #    |
  202.             | # # ###  |
  203.             \----------/
  204.  
  205.       whereas set to 9 it would be more likely to come out as this:
  206.  
  207.  
  208.             |          |
  209.             |#### ## ##|
  210.             |###### ###|
  211.             | #########|
  212.             \----------/
  213.  
  214.  
  215.          passover/no passover
  216.          --------------------
  217.  
  218.       Toggles the restriction that stops lines you give your opponent being
  219. full.  if 'no passover' is selected then the max number of blocks in a line
  220. you give your opponent will be 9.  If 'passover' is selected then 10 blocks
  221. in the line will be possible (i.e. the line could be full).  The reason this
  222. is called passover is that if its on (i.e. 'passover' selected) and you got,
  223. say, a tetris', and it filled up 2 of the lines your opponent recieved,
  224. thenyou would get one back! (because he just got a double).  The lines
  225. passed back over to you.
  226.  
  227.       With this on it's perfectly possible to kill yourself, especially if
  228. 'get' is set at 9 (which will fill lines approximately 35% of the time).
  229.  
  230.  
  231.         swap scores
  232.         -----------
  233.  
  234.       Swaps the number of wins per player around.  Handy if you want to
  235. switch controls after a while (cramp or some system of 'fairness').  Both
  236. players have to hit fire on this one.
  237.  
  238.  
  239.  
  240.  
  241.    The BlockDesign program
  242.    -----------------------
  243.  
  244.  
  245.    Not everyone's tastes are the same (mine vary according to what day it is),
  246. so Tetris has an option that allows you to use a different set of blocks.
  247. The different sets of blocks are stored in the 'blocks/' sub directory,
  248. which should be in the same dir as the Tetris program.  BlockDesign should
  249. also be in the same dir as the Tetris program.  When you click on it it will
  250. pop up a file requester (in the blocks dir) asking you to select a blocks
  251. file.  It should contain (to start with) something like:
  252.  
  253.       checked
  254.       plain
  255.       colour-square
  256.       square
  257.       torn
  258.       marble
  259.       stone
  260.       gold
  261.  
  262.    These are the blocks supplied with Tetris
  263.  
  264.    Double clicking on one of these will copy it into the tetris.shapes file
  265. in the Tetris program directory, selecting the block set.*
  266.    If, in the blocks dir there is also a relevant palette file for the block
  267. file you selected, this will also be copied to the Tetris program dir.  I.E.
  268. if you select 'torn' and 'torn.pal' exists, then this will also be copied
  269.  
  270.    *.  If you want to have a smaller installation, simply delete the blocks
  271. directory and the BlockDesign program, making sure you have a valid
  272. tetris.shapes file in the tetris program directory (run Tetris - if it
  273. works, you've got the file).
  274.  
  275.    The BlockDesign program is not a necessary file for tetris to work (see
  276. bottom bit for a list of necessary files)
  277.  
  278.  
  279.  
  280.    The Grabber program
  281.    -------------------
  282.  
  283.    You may be thinking: Having the BlockDesign thingy is all very nice, but
  284. all his blocks are shit, and you'd basically be right (I am *not* a very good
  285. artist), but cheer up - you can draw your own blocks to use.
  286.  
  287.    In the Tetris program directory there should be a 'gfx' dir containing a
  288. tetris.iff picture file.
  289.    This is a template, and what you should use to draw your own blocks.
  290. (It is actually the picture file that the 'plain' block set was grabbed off
  291. of).
  292.  
  293.    To create your own blocks, simply do this:
  294.  
  295.    1)   Load up DPaint (or whatever you use), with a screen format of
  296. 320x256x16 colours.
  297.  
  298.          The colours work like this:
  299.  
  300.             0     Background
  301.             1     Block Shadows
  302.             2     Block Middle colour dark
  303.             3     Block Middle colour light
  304.             4     Block Highlight
  305.             6     Menu Text
  306.             7     Menu Shadow
  307.             8     Menu Highlight
  308.  
  309.        10-14      Use as you want
  310.  
  311.           N.B. colours 2 & 3 can really be used for anything, but note that
  312.  it is these colours that are dithered together in BiTetris to make the sent
  313.  over lines.
  314.  
  315.          The palette on the tetris.iff file should give you an idea.
  316.           More info on changing the palette
  317.  
  318.    2)   Load up the tetris.iff file.  You should see collection of 3d blocks.
  319.  
  320.    3)   Draw your designs.  You should keep the same shape as the ones
  321. given, and its a good idea to keep the shapes with the 3d edges, as Tetris
  322. has some in built 3d stuff, and will act like the blocks are 3d even if they
  323. are not.  If you dont want 3d, then the only solution is to set the palette
  324. for colours 1 & 4 to the same RGB, and use one of them as a 2d border round
  325. the blocks.
  326.  
  327.       *DO NOT MOVE THE BLOCKS ABOUT*
  328.       Grabber needs the blocks to be in the correct position.
  329.       DO NOT MOVE THE BLOCKS - draw inside them.
  330.  
  331.       The easiest way to do this is to draw your design on the first block
  332. of each set, then using brush and rotate functions, paste it over the rest.
  333. It is possible to use the same brush for all the L shapes, ditto for the S
  334. shapes, by using the mirror function.
  335.  
  336.       Once you've done that, switch to a reserve screen and load up the
  337. gfx/borders.iff file.  This is all the outlines of the shapes.  Grab it as a
  338. brush, switch back to your picture, and paste it over your shapes - instant
  339. 3D!
  340.  
  341.    N.B. Blitz can't handle iff's that have been saved with a stencil, so
  342. don't.
  343.  
  344.    4)   Save your picture in the 'gfx' dir, as something like
  345.               'myblocks.iff'
  346.  
  347.    5)   Run the Grabber program
  348.  
  349.    6)   The first requester should open out into the 'gfx' dir.
  350.         In it select your picture file 'myblocks.iff'
  351.  
  352.    7)   In the second requester, it should automatically have opened into
  353.         your 'blocks' directory.  If not then find your blocks dir, then
  354.         type in a filename at the prompt : this will be what your block set
  355.         is called.
  356.  
  357.    8)   Grabber should load your picture, scan for the blocks, then save
  358.         them.  Once you hit the mouse, it will clear the screen, then
  359.         reload them.  If they all appear OK on the screen it should have
  360.         worked.  Hit the mouse again to exit.
  361.  
  362.          N.B. grabber will also save your pictures palette to the relevant
  363.          palette file in the blocks dir.
  364.  
  365.    9)   Run BlockDesigner, and double click on you block set
  366.  
  367.   10)   Run Tetris and start a game - you should have your own little set
  368.         off blocks. Aren't they nice?
  369.  
  370.   11)   If your blocks are nicer than mine (it wouldn't be hard would it?)
  371.         then you can send me your blocks.
  372.  
  373.  
  374.  
  375.        Changing the palette
  376.        --------------------
  377.  
  378.    The colour info for Tetris is kept in the 'tetris.pal' file in the Tetris
  379. program dir.  it looks like this:
  380.  
  381.          0     Background
  382.          1     Block Shadows
  383.          2     Block Middle colour dark
  384.          3     Block Middle colour light
  385.          4     Block Highlight
  386.          5     White
  387.          6     Menu Text
  388.          7     Menu Shadow
  389.          8     Menu Highlight
  390.          9     Menu Text Highlight
  391.          10    Null
  392.          11    Null
  393.          12    Null
  394.          13    Null
  395.          14    Null
  396.          15    Menu Background Highlight
  397.  
  398.    You cannot set colours 5,9,15 as they are reset by the program.  You can
  399. edit all the rest.  
  400.    You can do his easily enough - just load the palette file into DPaint (or
  401. whatever) and change the values, then save.
  402.  
  403.    There is a file: 'gfx/palette.iff' that displays a menu and a block - handy
  404. for designing your palette.
  405.  
  406.    NOTE
  407.    ----
  408.  
  409.    Some (all) of the blocks in the blocks dir have .pal palette files.
  410. BlockDesign will copy these over onto tetris.pal as well as the actual shape
  411. file.  Either delete the block.pal files, or change them instead of the
  412. tetris.pal file, or keep a backup of your palette in the defaults directory.
  413.  
  414.     The recommended method is to edit the block.pal files, as each block set
  415.   works best with a palette designed for it (if you used the 'plain' palette
  416.   with the 'marble' blocks it would look *so* crap)
  417.  
  418.    If you manage to loose your blocks/palette, the default ones are in the
  419. defaults directory - simply copy them across.
  420.  
  421.  
  422.  
  423.  
  424.       Vanilla Tetris is Shareware.  If you play it a lot (which hopefully
  425. lots of you will), you should send me some money.  5 pounds sterling (8
  426. dollars I think) sounds about right to me for the phase reversal that
  427. resulted from writing this (I ended up awake/asleep in the wrong 12-hour
  428. cycle, with the Flu).  You can send the money to the address below.
  429. Please support Shareware, as some authors will stop writing cool stuff
  430. if you don't.
  431. (I won't, but thats no reason not to send me money)
  432.  
  433.   Do note that if I don't get very much money out of this, I won't release the
  434. bug fixes and/or upgrades.
  435.  
  436.  
  437.  
  438.    The files you have should be:
  439.  
  440.          Vanilla
  441.          Vanilla.info
  442.          BiTetris
  443.          BiTetris.info
  444.          Vanilla.doc
  445.          Vanilla.doc.info
  446.          BlockDesign
  447.          BlockDesign.info
  448.          Grabber
  449.          Grabber.info
  450.          tetris.shapes
  451.          chars.shapes
  452.          tetris.pal
  453.          sfx/
  454.             BassDrum2
  455.             Ohman
  456.             FallingPiano
  457.             thunder
  458.          defaults/
  459.             tetris.shapes
  460.             tetris.pal
  461.          gfx/
  462.             tetris.iff
  463.             palette.iff
  464.             borders.iff
  465.          blocks/
  466.             checks
  467.             checks.pal
  468.             plain
  469.             plain.pal
  470.             squares
  471.             squares.pal
  472.             colour-squares
  473.             colour-squares.pal
  474.             torn
  475.             torn.pal
  476.             marble
  477.             marble.pal
  478.             stone
  479.             stone.pal
  480.             gold
  481.             gold.pal
  482.  
  483.    If they aren't there then they SHOULD BE!
  484.  
  485.  
  486.    Here is a list of the files that Tetris *needs* to run
  487.  
  488.       Vanilla
  489.       BiTetris
  490.       tetris.pal
  491.       tetris.shapes
  492.       char.shapes
  493.       sfx/
  494.          BassDrum2
  495.          Ohman
  496.          FallingPiano
  497.          thunder
  498.  
  499.    Of course, I wouldn't recommend deleting the docs or the icons for
  500. Vanilla & BiTetris.
  501.  
  502.  
  503.  
  504.    A list of credits here:
  505.    -----------------------
  506.  
  507. Programming and graphics were all done by me: Iain King
  508.  
  509. The 'Torn' block design was based on the blocks in Tetris Pro, done by: Art
  510.  
  511. The marbling texture for the 'marble' blocks was off: the A on the AF
  512.                                                       Photogenics coverdisk
  513.                                                       (so thanks to Amiga
  514.                                                                     Format)
  515.  
  516. Ohman taken from MotherLode, which was written by: Some cool bloke (I can't
  517.                                                    find the disk - sorry)
  518.  
  519. Thunder taken from 'The Dark', a totally excelent mod by Nico Arianoutsos
  520.  
  521.  
  522.  
  523.  
  524.    Bugs
  525.    ----
  526.  
  527.    There is a bug with the keyboard - it occasionally locks up.  I'm 99%
  528. sure that this is Blitz's fault and not mine, so don't bother telling me
  529. about this one.  If it severely annoys you then
  530.       a) pretend its a random difficulty enhancer
  531.       b) use the (eurch) joystick , or (in BiTetris)
  532.       c) a leveller because the other player has to put up with the joystick
  533.  
  534.    I get really happy if people report bugs to me, so please do.
  535.  
  536.  
  537.  
  538.  
  539.    My address
  540.    ----------
  541.  
  542.    I can be reached through lots of places (2 at least):
  543.  
  544.     Stuff I want you to send would be money, blocks/palettes you've made and
  545.   bug reports.  Note however that unless you register any blocks/palettes you
  546.   send will *NOT* be put in the next release. (you can still send them -
  547.   I wouldn't mind having more block sets)
  548.  
  549.    If your sending stuff, then this is the address:
  550.  
  551.  
  552.             Blairs Croft
  553.             Creetown
  554.             Newton Stewart
  555.             Scotland
  556.             DG8 7DF
  557.  
  558.    Bugs reports can go there too, but more preferable is my email address,
  559. which is:
  560.  
  561.       iking@cs.strath.ac.uk
  562.  
  563.    And if you want you can check out my web site (it's got some other Amiga
  564. stuff I made on it) at:
  565.  
  566.       http://www.strath.ac.uk/~aeu95140/
  567.  
  568.    Have fun!
  569.  
  570.  
  571.  
  572.   There haven't been many versions of Vanilla Tetris, but here's the list:
  573.  
  574. ----------------------+----------------------------------------------------------
  575.       v1.00           |     First release.
  576. ----------------------+----------------------------------------------------------
  577.       v1.01           |     Added BiTetris two player version,
  578.                       |  rewrote Grabber from scratch (so now it actually works),
  579.                       |  and converted these docs to AmigaGuide format.
  580.                       |  Also, shapes now rotate around their centres
  581. ----------------------+----------------------------------------------------------
  582.       v1.02           |     Fixed bug where when shapes first appear you cannot
  583.                       |  immediately rotate the lines or 1 of the L's.  Also, in
  584.                       |  BiTetris, both players now get the same blocks.
  585. ----------------------+----------------------------------------------------------
  586.  
  587.